MLX CAPTION — Installation guide
================================

Thank you for downloading MLX Caption!

REQUIREMENTS
  • Mac with Apple silicon (M1, M2, M3, M4 or newer)
  • macOS 14 Sonoma or newer
  • 16 GB memory recommended (8 GB works with smaller models, chosen automatically)
  • About 8–15 GB of free disk space for the AI models
  • Internet connection for the one-time setup (the app works offline afterwards)


STEP 1 — Move the app
  Drag "MLX Caption.app" into your Applications folder.


STEP 2 — Open it the first time
  macOS shows a warning the first time you open apps downloaded outside the
  App Store. To open MLX Caption:

  macOS 15 Sequoia and newer:
    1. Double-click MLX Caption. When the warning appears, click "Done".
    2. Open System Settings → Privacy & Security.
    3. Scroll down. Next to "MLX Caption was blocked…", click "Open Anyway".
    4. Confirm with your password or Touch ID.

  macOS 14 Sonoma:
    Right-click (or Control-click) MLX Caption → Open → Open.

  You only need to do this once.


STEP 3 — One-time setup (2–5 minutes)
  Click "Set Up". MLX Caption installs its components in the background and
  opens automatically when it's ready.


STEP 4 — Download the AI models (in the app)
  Click "Download models". The download size depends on your Mac's memory
  (about 6.5 GB for 8–16 GB Macs, about 13 GB for 24 GB+ Macs). You can start
  transcribing as soon as speech recognition has finished downloading.
  If the download is interrupted, click "Resume" — progress is kept.


FREE TRIAL AND LICENSE KEY
  MLX Caption works without a license key for your first 5 videos, with
  every feature switched on. Videos that fail or that you cancel don't count.

  To keep using it after that, buy a license ($49 once, no subscription):
      https://sassproducthub.gumroad.com/l/mlx-caption

  Already bought it? Your license key is on your Gumroad receipt and in the
  email Gumroad sent you. In the app, click "Enter license key" (top right),
  paste the key and click "Activate". You need to be online for that step.

  What the license check sends: only the key, to Gumroad, when you activate
  and about once a week afterwards. If you're offline the app keeps working.
  Your videos, audio and transcripts are never sent anywhere.


USING MLX CAPTION
  1. Drop a video (MP4, MOV, MKV, WebM, AVI) or audio file into the window.
  2. Choose the languages for subtitles (15 are selected by default).
  3. Click "Start processing".
  4. Watch the video with subtitles, search the transcript, and download
     SRT / VTT subtitles, the transcript, a summary, or a video file with all
     subtitle tracks embedded.

  Everything runs on your Mac. Your videos are never uploaded anywhere.


TROUBLESHOOTING
  • Setup failed: check your internet connection and open the app again.
  • Logs: ~/Library/Logs/MLX-Caption.log
  • Your projects and models are stored in:
      ~/Library/Application Support/MLX-Caption
  • To uninstall: delete MLX Caption.app and the folder above.


SUPPORT
  Email tabishhassan01998@gmail.com (or reply to your Gumroad purchase email)
  and include the log file above.
